User Documentation
Gateways
Here you can find the setup instructions for the currently supported gateways.
playSMS
URL: https://playsms.org/ Stability: Experimental
Use the Webservices provided by playSMS for sending SMS.
SMSGlobal
URL: https://www.smsglobal.com Stability: Experimental
Use the Webservices provided by SMSGlobal for sending SMS.
Signal
URL: https://www.signal.org/ Stability: Experimental
This gateways allows you to send messages via the Signal protocol.
Telegram
URL: https://www.telegram.org/ Stability: Unstable
This gateway allows you to send messages via the Telegram protocol. Once the administrator has finished the general Telegram authentication gateway setup (Check out the Administrator Documentation for further details), you need to follow these instructions to activate the use of the gateway for a user:
- Find out your own Telegram user id
Open your Telegram client, search for @my_id_bot
and start a conversation.
In reply @my_id_bot provides your personal id to you, e.g. 998877665
.
Remember: Keep your personal id private unless you trust a person!
-
Contact the newly created bot
-
Open your Telegram client, search for
@my_nc_bot
(The administrator provides the bot name to you) and start a new conversation. -
Send e.g.
Hello
. -
Activate the authentication gateway for a user
-
Log in to Nextcloud with the user you want to enable the twofactor gateway for.
- Open Settings -> Personal -> Security and navigate to the
Message gateway second-factor auth
configuration. - Press the
Enable
button under the Telegram label. - Enter the previously evaluated personal user id, e.g.
998877665
and press theVerify
button. - Now you should receive a Telegram message with your Nextcloud authentication code,
e.g.
123456
. - Enter the received Nextcloud authentication code and press the
Confirm
button.
Finally the system should state Your account was successfully configured to receive
messages via Telegram.
Remember: As a next step you should immediately generate Two-Factor Authentication backup codes to be able to login, in case the Telegram service fails.
XMPP
URL: https://xmpp.org/ Stability: Unstable
This gateway allows you to send messages via the XMPP over HTTP protocol. Once the administrator has finished the general XMPP authentication gateway setup (Check out the Administrator Documentation for further details), you need to follow these instructions to activate the use of the gateway for a user:
Activate the authentication gateway for a user
- Log in to Nextcloud with the user you want to enable the twofactor gateway for.
- Open Settings -> Personal -> Security and navigate to the
Message gateway second-factor auth
configuration. - Press the
Enable
button under the XMPP label. - Enter the JID (XMPP Address) you wish to get your authentication code to and press the
Verify
button. - Now you should receive a XMPP message with your Nextcloud authentication code,
e.g.
123456
. - Enter the received Nextcloud authentication code and press the
Confirm
button.
Finally the system should state Your account was successfully configured to receive
messages via XMPP.
Remember: As a next step you should immediately generate Two-Factor Authentication backup codes to be able to login, in case the XMPP service fails.